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1.0 General 

DOT is the debugging system for the SDS 930 Time-Sharing System* It has 

facilities for symbolic reference to and typeout of memory locations and central 

registers. Furthermore, it permits the use of literals in the same majiner as in 

the assembler. It can also insert breakpoints into programs, perform a trace, 

and search programs for specified vords and specified effective addresses. There 

is a command to facilitate program patching. Finally, DDT can load lMPlh absolute 

and relocatable files in the format produced by the assembler. 

The system has a language for communication between DDT and its users. The 

basic components of this language are symbols, constants, and commands . 

1.1 Symbols 

A symbol is any string of letters, digits, and dots (•) containing at 

least one letter. (However, a digit string followed by B or D is interpreted 

as an octal or decimal number resx>ectively). In symbols of more than six 

characters, only the first six are significant: thus, ALPHABET is equivalent 

to ALPHAB. All opcodes recognized by the assembler are built-in symbols, 

except for some l/O instructions. Other symbols are ;1, ;2, ;A, ;B, ;F, 

;L, ;M, ;Q, ;X, and dot. Their meanings are explained below. 

Every symbol may have a value. This value is a ?U-bit integer; for 

most symbols it will be either an address in memory or the octal encoding of 

an operation code. Examples: 

ABC 

ABI2U 

12XYZ 

The following are not symbols: 

135B 
AB*CD 

Symbols may be introduced to DDT in two basically different ways: 

(a) They may be written out by the assembler and read in from 

the binary program file by DDT. 
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(b) They may be typed in and assigned values during debugp;ing. 

It is possible for a symbol to be undefined. This may occur if a progro/n 
is loaded which references an external symbol not defined in a previously 
loaded program. It may also occur if an ijindefined symbol is typed in an 
expression, 'in general, undefined symbols are legal input to DDT except 
when their values would be required inmediately for the execution of a 
command. Thus, for example, the ;G (GO TO) command could not have an unr- 
defined symbol as its argument. 

Undefined symbols may become defined in several ways. They may be 

, * ^ '- ' ' 

defined as external in the assembler (i.e. with EXT, ENTRY, or $) and read 
by DDT as part of a binary program. Alternatively, they may be defined by 
one of the symbol definition commands available in DDT. When the definition 
occurs, the value of the symbol will be substituted in all the expressions 
in which the symbol has appeared. 

If DDT type [V] after typing out the contents of a register, it means 
tTiat the register contains an undefined symbol. The register is closed at 
once so that its contents cannot be erroneously changed. 

The only restriction on this facility is that, as for ARPAS, the 
undefined symbol must be the only thing in the address field of the word 
in which it appears. Incorrect uses of undefined symbols wMl be detected 
by DDT and will result in the error comment (u). 

DDT keeps track of references to undefined symbols by building a 
pointer chain through the address fields of the words referring to the symbol. 
Thus, suppose that the symbol A is undefined and appears as follows 

51 LDA A 

52 STA A 

53 IfilG A 

and noTrfhere else in the program. After loading, the entry for A in DDT's 
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symbol table vd.ll contain a flag indicating that it i8 undefined and a pointer 
to 3. The above locations will contain: 

51 LDA 

52 STA 81 

« 

53 MRG 32 

When the symbol is defined^ DDT goes through the pointer chain and fills in 
the value. It recognizes the end of the pointer chain by a address. 

From this description it should be obvious i*hat will happen if the 
pointer chain is destroyed. A probable consequence is that a search down the 
pointer chain will not terminate. DDT does sucu searches whenever it prints 
an address. If the chain it is searching has more than 256 links, it will 
print the symbol followed by (U) and continue. Fixing up an undefined symbol 
pointer chain which has been clobbered is an exercise which we leave to 
the reader. 

1.2 Block Structure 

A limited facility called the block structure facility is provided to 
simplify the referencing of local symbols which are defined in more than one 
program. Note that DDT's block structure has only a tenuous connection 
with the block structure of ALGOL. The block structure of a program is 
organized in the following manner: every XDENT read by DDT as part of a 
binary program file begins a new block. Any local symbol known to DDT has a 
block number associated with it; global symbols do not have a block number. 
Undefined symbols are always treated as global.. 

The name of a block is the symbol in the label field of the XDEMT. If 
two IDENTs with the same symbol are read, the message (AIHEADY DEFINED) is 
printed, and the local symbol tables from the two blocks will be merged. 
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Global symbols must be unique within an entire program and are recofpnized 
tt all times. If a multiple definition is encountered, the latest one takes 
precedence* Local symbols are recognized according to the following rules: 

(1) At any given time one block is called the primary block. All local 
symbols associated with the primary block will be recognized. 

(2) If a symbol is used which is neither global nor in the primary 
blocks the entire symbol table is scanned for it. If it occurs 

in only one block, the symbol is recognized properly. If it occurs 
in more than one block, the error message (a) is printed. 

(3) A symbol may be explicitly qualified by writing: 

SYMA&SWB 
SlflMLA must be the name of a block. SWB is then referenced as though 
the block whose name is SYMA were primary. 
(k) When a register is ox)ened (see section 2.1), the block to which 
the symbolic part of Its location belongs becomes primary. Thus, 
NN&XYZ/ causes block NN to become prijnary; if ABC is a unique local 
symbol in block PQ, then ABC/ causes block PQ to become primary. 
1.3 Literals 

Literals have the same format and meaning in DDT as in the assembler > 
i.e. the two characters' -' signal the beginning of a literal, which is 
terminated by any of the characters which ordinarily terminate an expression. 
In contrast to the assembler, the expression in a DDT literal must be defined. 

The literal is looked up in the literal table. If it is found, the 
address which has been assigned to it is the value of the symbol. If it 
does not appear in the literal table, it is stored at the address which is 
the current value of ;Tj and this address is taken as the value of the 
literal. ;F is increased by 1. For example, if the literal -1 does not 
already exist in the literal table and ;P is lOOOB, then IDA =*1 causes -1 
to be stored at lOOOB, and is equivalent to LDA lOOOB; the new value of ;F 
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is lOOlB. Exception: In patch mode, literals are saved and not stored 

until the patch is completed since otherwise they would interfere with 

the patch. 

When DDT types out a symbol whose value is an address in the literal 

table, it will type out in the same format in which it would be Input; that 

is, as = followed by the numeric value of the literal. 

1,4 Const/mts 

A constant is any string of digits, possibly followed by a B or D. The 

-» 
number represented by the string is evaluated, truncated to 2U bits and then 

used just like the value of a symbol. The radix for numbers is normally 8 

(octal), but may be changed arbitrarily by the commands described in section 

2,k below. If a number is terminated by B or D, it is interpreted as octal 

or decimal respectively regardless of the current radix. Constants are 

always printed by DDT in the current radix. 

It is possible to enter numeric op codes by typing the number followed 

by an ^ sign. Thus 100^ =lUUOOOOOB if the current radix is decimal (100D=1UUb). 

1.5 Commands 

A command Is an order typed to DDT which Instructs it to do something. 
The commands are listed and their functions explained in the table below. 

1.6 Expressions 

An expression is a string of numbers or symbols connected with blanks, 
+> -^ ;*> ;/^ ;&? ;<> ;=> ;>> sund ;^. These operators have the following 

significance: + addition 

subtraction 

♦ (integer) multiplication 

/ (integer) division 

& (AND) ^ 

< (LSS) / 

= (EOX) > as in ARPAS 

> (GTR) / 

i (OR) J 

Expressions are evaluated strictly left to right: all operators have the 

same precedence. Parentheses are not allowed. The first symbol or number 
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may be preceded by a minus sign. Blank acts like plus, except that the 
follovinp; operand is tr^mcated to lU bits before being added to the 
accumulated value of the expression. The value of an expression is a r^^i-bit 
integer. An expression may be a single symbol or constant. 

Examples: LDA has the value 76OOOOO 

LDA 10 has the value 76OOOIO if the 

radix is octal 
LDA lOD has the value 76OOOI? 

If 3YM is a symbol \-/ith the value 1212, then 

Sm has the value 121P 

SYM 10 has the value 1222 

LDA SYM has the value O76OI212 

If this last expression vere put into a memory register and later 
executed by the program the effect would be to load the contents of oTA, 
register 1212;^ into the A register. 

When DDT t5rpes out express ions ^ two mode switches control the fomiat of 
the output. Commands for setting these modes are described in section J.^i- 
below. The C-S mode determines whether quantities will be printed as constants 
or as sjnnbolic expressions. In the latter case^ the opcode (if any) and the 
address will be put into symbolic form. If the first nine bits of the value 
are or 1^ no opcode will be printed; in the latter case a negative integer 
will be printed. If the opcode is not recognizable as a symbol, it will be 
typed as a number followed by an (V- sign. 

The R-V mode controls the format in which addresses are typed. DDT 
types addresses when asked to open the previous or the next register, when 
it reports the results of word and address searches, and on breakpoints. 
In relative mode, addresses are typed in symbolic form, i.e., as the largest 
defined symbol smaller than the address plus a constant if necessary. If 
the constant is bigger than 200 octal, or if the value of the symbol is 
less than the first location of the program, the entire address is typed as 
a constant. In absolute mode, addresses are always typed as constant. 
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1.7 The Open Register 

One other major ingredient of the DDT language is the open regiater . 
Certain commands cause a register to be "opened'*. This means that its 
contents are typed out (except in enter mode^ for which see the \ command), 
followed by a tab. Any expression the user types will then be inserted into 
the open register in place of its current contents. After this insertion the 
register is closed at once. Note that the string LDA ABC= is a command, and 
does not cause LDA ABC to be entered into the current open register. The 
current location is given by the symbol "." (dot) which always has as its 
value the address of the last register opened, whether or not it is still open. 

Note : 

(1) Comma and star (for indirect addressing) may be used in expressions 
as they are used in the assembler; e.g. LDA* 0,? has the value 
276^0000. 

(2) DDT will respond to any illegal input with the character ? followed 
by a tab (if a register is open) or carriage return (otherwise), 
after which it will behave as if nothing had been typed since the 
last tab or carriage return. The command ? also erases everything 
typed since the last tab or carriage return. 

1.8 Memory Allocation and DDT 

DDT may cause the time-sharing system to assign memory for use either 
by DDT itself or by the user's program. DDT's memory is used to hold the 
symbol table, which starts in block and grows upward in memory. The 
symbol table contracts at the end of each load of a binary file and when 
symbols are killed; this contraction may cause memory to be released. 

DDT grabs program memory when it is required for loading a binary file, 
or when a ;U (execute) command is given and the value of ;P is such that 
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a new block is needed to hold the instruction to be executed. For executing 
an instruction, DDT requires location ;r, ;F+1 and ;r-f-2. Memory is never 
grabbed for examination of a register; however, entering information with \ 
can cause memory to be assigned. Attempts to open locations not assigned 
will cause DDT to type ?. This means that upon initial entry to DDT no 
registers are available for examination. The easiest way to obtain memory 
Is to simply start typing in a program using the \ command. 

If an attempt to acquire or reference memory leads to a trap, DDT types 
(m) and abandons whatever it is doing. This can happen if the machine size 
is exceeded, or if an attempt is made to change read-only memory. 



< 
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2.0 DDT Commands 

In the following descriptions of DDT commands, <a> will be used to denote 
an arbitrary symbol. <E> or <W> will be used to denote an arbitrary expression 
which may be typed by the user: <E> will be used when the value of this expression 
is truncated to lU bits before it is used by DDT, while <Vt> will denote a full 
2U-.bit expression. <A> will be used to denote an optional lU-bit expression. 
If none is typed, the last expression printed out will usually be used; deviations 
from this rule will be described under the individual commands. <?> will denote 
a file name followed by a dot: DDT will type a tab whenever it expects a file 
name. 

2.1 Register Opening Commands 
k> j This opens the register addressed by the value of </C>. DDT will give 

a tab, type an expression whose value is equal to the contents of the 
register, give another tab and await further commands. The precise form of 
the expression typed is dependent on the setting of the S-C and E-V modes. 
If the user types in an expression, DDT will insert its value into the 
register. Typing another command closes the register, unless it is a type 
value or nymbol definition command. Note that in a coiranand that requires 
a preceding expression, the expression is regarded as part of the ccamnand 
and would not, for instance, be inserted into the open register. If another 
/ is given as the next command with no preceding expression the contents 
of the register addressed by the expression typed by DDT are typed out. A 
further / repeats this process. Note, however, that the original register 
opened remains the open register; any changes made vill go into that register, 

carriage Tnis command does not necessarily have any effect. If the specified 
return 

conditions are present, however, any of the following actions may occur: 
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(1) If there is an open register, the register is closed. 

(?) If DDT is in enter mode, it leaves it. 

(3) If DDT is in patch mode, the patch is terminated (for a 

fuller description of this effect, see the patch command). 

<A> ] This command has the same effect as /, except that the contents of 

the register opened are always typed in symbolic form. 
<P'> [ This command has the same effect as /, except that the contents of 

the register opened are typed in constant form. 
<P> $ This command has the same effect as /, except that the contents of 

the register opened are typed as a signed integer. 
<E> '* This command acts like /, except that the register constants are typed 

in ASCII. Unprintable characters, as in QED, are preceded by &, e.g. lUl 

(control-A) prints out as &A. 

line This command opens the register whose address is the current location 
feed 

plus one, i:ie. the register after the one just opened. The output of DDT on 

this command is carriage retum, register address (format controlled by 

the R-V mode), /, tab, value of contents, tab. 

;t>(o=space) This is equivalent to line feed except that nothing is printed. 

Its main use is in entering programs or data, e.g. 

1000 l;t>2'^3 (carriage return) 

is equivalent to 

1000\ 1 (carriage return) 
1001\ 2 (carriage return) 
1002 \ 3 (carriage return) 

t This command opens the register whose address is the current location 

minus one, i,e. the previous register. The output is the same as for the 

line feed command. 



Example : 








ABC/ 


LDA 


ALHIA 


(line feed) 


ABC+1/ 


STA 


BETA 


STA GAJMA (line feed) 


ABC +2/ 


LDB 


DELTA 


t 


ABC+1/ 


STA 


om/iA 
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( This command opens the register "whose address is the last 1^ bits 

of the value of the last expression typed. The output is the same as for 
line feed. 

\ This command is the same as /, except that the contents of the ref7ister 
are not typed. DDT goes into enter mode, in which the contents of rep^isters 
opened by line feed, t, or ( are not typed. Any other command caused DDT 
to go out of enter mode. In particular, carriage return has this effect. 
When a register has been opened with \, DDT thinks that it has typed out 
the contents* The type value comma.nds will, therefore, work on the contents 
of the register. 

The type register in special mode characters [, }, $ (t,7pe as a negati-^e 
integer), " (type in ASCII) are also preserved by line feed, vp arrow and (. 

;\ This commarid suppresses typeout of register addresses durinr^ line feed, 
up arrow and ( chains. Carriage return cancels the command. 

2.r^ Type Value Commands 
= This command t:ypes the value of the last expression typed (;Q) in 

constant form. It may appear in the form <W> ^, in which case the valt^e 

of the <K> is typed. Otherwise, the expression referred to is the one most 

recently t5rped, either by DDT or by the user. 
# This command types the value of ;Q as a signed integer. 
^ This command types the value of ;Q in symbolic form. 
* This command types the value of ;Q typed as a word of text (see " command 

on previous page). 
(^-^ This command types the address part of ;Q in symbolic form. If, for 

instance, the program has executed BRM X, then X\§ will cause DDT to print 

the address of the HRM. 
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Example : 

LDA= 


7600000 


LDA 10= 


7600010 


LDA <- 


LDA 


7600000«- 


LDA 


-1- 


77777777 


-3# 


-1 


77777777# 


-1 


10P210U3' 


ABC 



<^ 



p. 3 Symbol Definition Commands 
<S> : This commajid defines the value of the symbol<S> to be the 

current location* If <3> has been used but is undefined^ it becomes global; 

otherwise it becomes local and associated with the block which is primary 

\rhen the : cominand is given. 
<S> &' This command defines the value of <S> to be the address of the last 

expression typed by DDT or the user. The symbol is local and associated with 

the block which is primary when the @ command is given. 
(^<S>y This defines <S> to have the value of <K>_^ and to be global. 

2.U Mode Changing Commands 
" This command is followed by a string of arbitrary characters terminated 

by D' (control D)* If a register is open, the string will be inserted into 

successive locations packed 3 characters per word; otherwise characters 

beyond the third will be thrown away. For exairrpjle^ if no register is open, 

"ABCDED^- yields 10^210^3^ 
;D (decimal) This command changes the current radix (see section l.U). 
;0 (octal) This ch?ingcs the current radix to octal* 
<E> ;H (radix) sets the current radix to the value of the expression, which must 

be >2. 
;[ (constant) This command changes the S~C mode to constant, i.e. makes / 

equivalent to [ . 
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] (symbolic) This command changes the S-C mode to symbolic, I.e. 

makes / eouivalent to ]. 
'' (ASCII) This makes / equivalent to '\ 
$ (signed integer) This makes / equivalent to $. 
B (relative) This command changes the R-V mode to relative. This 

mode determines the format for the output of addresses, both in symbolic 

expression and when generated by line feed and t. 
;V (absolute) This command changes the R-V mode to absolute. 

2.5 Breakpoint Commands 

<A>,<E>1 (breakpoint) <E>' sets breakpoint at the address ,?;iven by the value 
of the expression; <N>, <E>! sets breakpoint N (N must be between and 3 
inclusive). The effect is that if the program executes the instruction at 
this address control returns to DDT, which will print the address and the 
contents of the A, B and X registers and await further commands (see below). 
The break occurs before execution of the instruction in the breakpoint 
location. ;L is set to the location at which the break occurred. 

' (clear all breakpoints). * alone causes all breakpoints to be cleared. 

<A>;! (LIST OR CLEAR BREAKPOINTS) 

<R>;! causes breakpoint N to be removed, where K lies between and 3 

inclusive. ;! alone causes all breakpoints to be listed: if breakpoint 1 
is set at ABC-*-3, and no other breakpoints are set, then ;I produces the 
printout * ABC -^3 * * - 

<P>;P (proceed) This command restarts the program after a break. The 

program executes the instruction at the break and goes on from there. No 
breakpoint is removed unless this is specifically done by ! or ;1 so that, 
if the program arrives at this location again, another break will occur. 
If <E>;P is given, another break will not occur until some breakpoint has 
been reached that many times- 



30.^0,10 

2-6 

December ?, I966 

<A>;N (NEJCT) This command executes the instruction at ;L and breaks. 

This program provides a trace facility in that repeated executions of ;N 
will provide a running print out of the contents of the significant internal 
rep:.isters, instruction by instruction. The function is essentially the same 
as that of the step switch on the console. <E>;N will cause <E> instructions 
to be executed before the next break occurs. 

The ;N command follows the flow of control in the user's program. In 
particular, it will normally trace the execution of users* POPs (see ;0 
below). The execution of SYSPOPs, however, is not traced. In other words, 
a SYSPOP such as FAD (floating add) is regarded as one instruction by ;N. 
Cells ;F, ;F+1, and ;F-*"2 are used by ;N and ;P. 
<E>;S (step). This is equivalent to <E> repetitions of ;N. Note that this 

is not the same as <E>;N* 
<E>;V (advance). Tliis is equivalent to <E> repetitions of <P, and is not^ 

the same as <E>;P. 
<N>;0 (pop trace MODE). If <3»0, programmed operators (POPs) together 

with their associated subroutines will be treated like machine instructions 
for the ;N and ;S commands^ i.e. the break will not occur until control 
returns to the location following the POP. Since DDT determines when It 
should break by counting POPs, BRMs, SBRMs, BRHs and SBPBs, it can be 
fooled hy POPs i«rhich do sufficiently peculiar things. If <N><0, POP 
subroutines will be traced, i.e. the first break after the POP will be at 
the first instruction of the subroutine. 
<K>;U (SUBROUTINE TRACE MODE). If <IO=^l, BRMs or SBBMs together with the 
subroutine called will be treated as single instructions by ;N. The same 
algorithm is used as in ;0 to determine when to break. If <N>^0, subroutines 
will be traced explicitly. 



30.^0.10 
December P, I966 

Attempts to proceed through certain Instructions having to do with 
forks will produce erroneous results, and breakpoints encountered when 
the program is running in a fork will not do the right thing* Attempts 
to proceed through unreasonable instructions will cause the error comment 

$ > > . 

P. 6 Input/Output Commands 

<A>;Y<K:> DDT expects to find a binary program on the file <T>. If the 

prograiti Is absolute it is read in. If it in relocatable it is read in and 
relocated at the location specified by <A>. If the expression is omitted, 
relo^*atable loading commences at location ?UOB and continuef5 by Y)eginninp: 
each program in the first available location after the preceding one. 
After reading is complete, the first location not used by the program is 
typed out. Any local s.ymbols on the binary file are ignored, 

<A>;T<F> . This command is identical to ;Y except that is also reads local 

symbols from the file and adds them to DOT'S symbol table. Any s.ymbols on 
the file will be recognized by DDT thereafter. 

The following two points should be noted in connection with ;Y and ;T 
commands . 

1) The use of an expression before ;T or ;Y when the file is 
absolute (i.e. SAVE file or self --loading paper tape) is in error, 

2) The block read in becomes the primary block. 

;W<R> Causes all global symbols to be written on the specified file, in a 

format which can be read back in with ;T. 
;C<F> Causes all symbols to be written on the specified file, 

2.7 Search Commands 
<W>;W (word SEAJRGH) <*Nt>;W searches memory between the limits ;1 and ;P for 

cells whose contents match <W> when both are masked by the value of ;M, 



30JiO.IO 
December ?, I966 

The locations and contents of all such cells are typed out. 

'^^'J (NOT-WORD SEABCH), This is the same as ;W^ except that all registers 

which do not match <W> will be printed. This is useful, for example, in 
finding and printing all non-zero registers in a given part of m^^mory. 

<T>;E (EFFECTP/E ADDFESS SEARCH) « <E>;E searches memory between the limitn 

;1 and ;P for effective addresses equal to <E>* Indexang, if specified. In 
done with the value of ;X. Indirect address chains are followed to a depth 
of 6U. The addresses and contents of all words found are typed out. V/lien 
;W or ;E is complete, . is left pointing to the last register where the 
expression was found. 

2.8 The Patch Command 
<A> ) <A> ) causes a patch to be inserted* If a register is open and an 
expression is given, the expression is entered into the register. If a 
register is open, or if no expression is t:fped, the patch is made at . 
Otherwise, the patch is made at <A>. DDT inserts in this location a 
branch to the current value of ;F. When the patch is done, ;F is updated. 
It then gives a carriage return and a ) and waits for the user to type 
in the patch. Legal input consists of a series of expressions whose 
values are inserted in successive locations in memory. Each of these 
expressions should be terminated by line feed or ;t>> exactly as though the 
rrngrajTi were being typed in with the \ command instead of as a patch. The t 
command may be given in place of the line feed and has its usual meaning, 
except that the contents of the previous location are not typed. Two 
other commands are legal in patch mode. They are: 

(1) Colon, which may be used to define a local symbol with val>jc 
equal to the current location. 
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(2) Carriage return^ which terminates the patch* When the 
patch is terminated^ DDT inserts in the next available 
location the original contents of the location at which the 
patch was inserted. It then inserts in the following two 
locations branch Instructions to the first and second locations 
following the patch. This means that if the patch command is a 
skip instruction;, the program will continue to operate correctly. 
Any other command given in patch mode may cause unpredictable 
errors, 
<^>;I Is identical to the ) comma,nd except tha,t it puts the instruction 

being patched before the new code inserted by the proF,rammer instead of after, 

9,9 Miscellaneous Commands 
;? and ? This commands erase everything typed since the last tab or carriagf^ 

return. It is alw^ays legal, 
<E>;G (go to) <E:>;G restores the A, B and X registers which were saved when 

DDT was entered (unless they have been modified) and transfers to the 

location specified by the value of the expression, 
;K (KILIi) This command resets DDT's symbol table to its initial state. 

DDT will t5rpe back — OK and wait for a confirming dot. Any other character 

will abort the command. 
<^':K (kill). Removes only the symbol <S> from the table. 
<E>^<i>;L Sets ;1 and ;9 (the lower and upper brounds for searches) to the 

values of the first and second expressions respectively* 
;U (undefined). This command causes all undefined symbols to be listed. 
<E>;U (execute). This causes the value of the expression to be executed as 

an instruction. If it is a branch, control goes to the location branched to. 

In all other cases control remains with DDT. A single carriage return is 

typed before execution of the instruction. If the instruction does not 
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branch and does not skip, or returns to the following location, a $ find 
another carriage return are typed after its execution. If the instruction 
does skip, two dollar signs ($$) are typed followed by a carriage return. 

;?> (zero) <E>^<E>;Z sets to zero all locations between the value of the 
first expression and that of the second. ;Z alone releases all memory 
accessible to the user's program. DDT will type back *-0K and wait for a 
confirming dot. Any other characters will abort the command. If this 
memory is returned, due to later access by DDT or a pro^^ram, it will be 
cleared to zero. 

^ (LIST blocks). The names of all blocks are printed. 

?.10 Special Symbols 

The value of '* . " is the current location, i.e. the address of the 
last register opened. 

The following symbols refer to variotiS special registers of the machine < 
Their value is the contents of these registers as saved by DDT: ;X^ will 
print the saved contents of the X register. To change the contents of a 
register, a command of the form <E>;A is used. Tliis command sets the A 
register to the value of the expression. Whenever DDT executes any command 
involving execution of instructions in the user^s program, it restores the 
values of all machine registers. If any of these values have been changed 
b:;'^ the user, it is the changed value which will be restored. 

;A The value of this symbol is the contents of the A register. 

;B The value of this symbol is the contents of the B register. 

;X The value of this symbol is the contents of the X register. 

;L The value of this symbol is the contents of the program counter. 

The only reason for changing ;L is to set the location from which ;N will 
begin execution. 
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The values of the following special symbols are used by DDT in certain 
cornmands or are available to the programmer for his general enlightenment. 
These values may be changed in the same way that the values of the symbols 
for the central registers of the machine may be changed. 

;M The value of this symbol is the mask for word searches. 

;1 The value of this symbol is the lower bound for word and effective 
address searches. It may also be set by the ;L command. 

I? The value of this symbol is the upper bound for word and effective 

address searches. It may also be set by using ;L. 

;Q This symbol has a value equal to the value of the last expression 

t;«/ped by DDT or the user. It is useful^ for instance, if the programmer 
wishes to add one to the contents of the open register; he need only type 
;Q ^ 1^ 

;F The value of this symbol is the address of the lowest location In core 
not used by the program. New literals arid patches are inserted starting 
at this address. Note: like all other special symbols, ;F may be changed 
hy the command <E>;F» It is also vapdated as necessary by patches and 
literal definitions* 

2.11 Panics 

DDT recognizes four kinds of panic conditions: 

(1) Illegal instruction panics from, the user*s program. 

(2) Memory allocation exceeded panics from the user^s program* 

(3) Panics generated by pushing the rubout button. 

(k) Panics generated by the execution of BRS 10 in the user's program. 

For the first two of these conditions DDT prints out a message, the 
location of the instruction at which the panic occurred, and the contents of 
this location. The messages are as follows: 
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(1) Illegal instruction panic I > > 

(2) Memory allocation exceeded M > > 

(3) The other two types of panics cause DDT to type bell and 
carriage return- ;L and . will both be equal to the location 
at which the panic occurred. 

If a memory allocation exceeded panic is caused by a transfer to ?m 
illegal location, the contents of the location causing the panic is not 
available and DIft, therefore, types a ?. 

Two other panic conditions are possible in DDT» 

(1) If the rubout button is pushed twice with no intervening typing 

by the user, control returns to the executive. 
(?) If the rubout button is pushed while DDT is executing a command, 
execution and typeout are terminated and DDT types carriage return 
and bell and then awaits further commands. 

2.12 Multiple Program Debugging 

It is occasionally desirable to hold several programs with different 

maps and symbol tables in DDT simultaneously. This situation could be 

approximated using the DUMP and RECOVER commands in the time-sharing 

executive, but several commands -are provided in DDT itself to facilitate 

the -procens* 
<W.>,<WJ>;R (set map). The pseudo- re labeling for the program is set according 

to the value of <W > and <WJ>. This command is essentially equivalent to 

executing BRS kk with <Wj> in A and <^^ in B« 
^ (erase)- DDT types —OK and waits for a confirming dot- Any other 
character will abort the command. DDT then resets itself to its initial 

state, i.e. the symbol table, program map, breakpoints and modes are all 

reset. The program memory, however, is not released. 
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'ft) (dump)* This command also requires a confirming dot. The 

entire state of DDT is saved away and a number typed out which will allov/ 
this state to be retrieved by the ^ command (see below). DDT then 
resets itself as described under f>E above. 
K>fjl (RECOVEB). This command requires a confir-ming dot. If the present 
state of DDT has ever been dumped (i.e. was produced by ^B)^ it is dumped 
again. Then the state is restored exactly as it was when the ^ was given, 
whose number was the value of <E>. Using an illegal number for *^. cao 
lead to chaos* 



